home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d7 / host42.arc / HOST42.DOC < prev    next >
Text File  |  1990-04-10  |  55KB  |  1,189 lines

  1.                                                                       Page: 1
  2.  
  3.           HOST42.SLC and H42UTILS.SLC are SALT language scripts compiled to
  4.           run under the  TELIX.EXE (C) telecommunications  program  version
  5.           3.12.
  6.  
  7.  
  8.  
  9.                             H O S T 4 2 / H 4 2 U T I L S
  10.  
  11.                This program is  distributed under the  Shareware   concept.
  12.           Non-Registered  users of HOST42 are  granted a limited license to
  13.           use it  for a 4 week  trial period,  in order to  determine  it's
  14.           usefulness to you.  ANY other use of HOST42 after that period  is
  15.           strictly prohibited.
  16.  
  17.                                     WHY REGISTER?
  18.  
  19.           *  Registration allows you to use HOST42 on a regular basis.
  20.  
  21.           *  Registered users will receive mailed  notification of  updates
  22.              to the program.
  23.  
  24.           *  Registered users will also  receive top  priority in any  help
  25.              or comments they have/need.
  26.  
  27.           *  Registered  users  receive  copies of  program  which has  the
  28.              "UNREGISTERED" statement removed and  replaced  with one which
  29.              says "REGISTERED TO:" and which gives their names.
  30.  
  31.           *  Registered copies of  HOST42 have the  limit on  messages  and
  32.              files raised from 25  (current limit on  UNREGISTERED versions
  33.              of HOST42) to a higher limit of 99 messages and 999 files.
  34.  
  35.           *  Registered users receive two additional support programs:
  36.  
  37.              H42UEDIT.EXE : A true full-screen external user editor  allows
  38.                             editing of  ALL user  information,  as well  as
  39.                             easy addition of new users.
  40.  
  41.              MENUEDIT.EXE : A full-screen Menu Editing program which allows
  42.                             Reading and Writing to each specific menu. Thus
  43.                             enabling the sysop to personalize the different
  44.                             menus.
  45.  
  46.           Registration is $20.00 and covers all of the above features.
  47.  
  48.                  To Order:
  49.                           Make check or money order out to:
  50.  
  51.                                         Daniel Horn
  52.                                         2122 West Butler Drive #161
  53.                                         Phoenix, AZ  85021
  54.  
  55.  
  56.                                                                       Page: 2
  57.  
  58.           -----------------------------------------------------------------
  59.  
  60.           Please send:
  61.  
  62.           HOST42 Registration .............. $ 20.00 _____
  63.  
  64.           Disk Size:  5.25" ______   3.5" ______
  65.  
  66.           { Print }
  67.  
  68.           Name   :______________________________________________________
  69.  
  70.           Address:______________________________________________________
  71.  
  72.                   ______________________________________________________
  73.  
  74.                   ______________________________________________________
  75.  
  76.           Day Phone:(____)______-_______    Evening:(____)______-_______
  77.  
  78.           Current version I have ______
  79.  
  80.           Comments:_____________________________________________________
  81.  
  82.                    _____________________________________________________
  83.  
  84.                    _____________________________________________________
  85.  
  86.           { Optional }
  87.  
  88.           Computer Type:________________________________________________
  89.  
  90.           Color display [Y/N]: __
  91.  
  92.           Where did you hear about (and/or receive a copy of) HOST42?
  93.  
  94.           { } BBS   Name______________________  Ph #(____)______-_______
  95.  
  96.           { } Sig   Name________________________________________________
  97.  
  98.           { } CompuServe
  99.  
  100.           { } Friend
  101.  
  102.           { } Other ____________________________________________________
  103.  
  104.           -----------------------------------------------------------------
  105.  
  106.  
  107.                                                                     Page: 3
  108.  
  109.                This program evolved from the original  HOST.SLC/HCONFIG.SLC
  110.           programs,  and then the later revisions by Jon  Flemming found in
  111.           HOST2.SLC/H2CONFIG.SLC.
  112.  
  113.                HOST3 was written as a sort of pet project of mine, in order
  114.           to enhance the HOST2.SLC program, written by Jon Flemming. I felt
  115.           that although he had made some superb changes to Colin's original
  116.           HOST.SLC,  there was SO much more that  could be done to make the
  117.           program  even better.    So, I began working on it.   Over time I
  118.           I have made uncountable changes and have ended up with the latest
  119.           version of HOST42.  I hope you enjoy it!
  120.  
  121.  
  122.                These are the files needed to run the HOST42 program.   Some
  123.           of these will be created as needed, as well some of them are only
  124.           optional:
  125.  
  126.                NOTE:  HOST42 requires that it be run under Telix 3.12 only,
  127.                       it CAN be run under  3.11 but  will crash in  certain
  128.                       places due to usage of functions  which are  specific
  129.                       to 3.12 ONLY.
  130.  
  131.                HOST42.SLC - Main  Host  Mode file, must  be in  your  telix
  132.                             script directory.
  133.  
  134.                H42UTILS.SLC - Utilities  script,  it  contains  all of  the
  135.                               utilities.   It is  called  by the HOST42.SLC
  136.                               program.   It should  also be in  your  telix
  137.                               script directory.  You can also run  H42UTILS
  138.                               by itself by typing H42UTILS  after  pressing
  139.                               ALT-G.
  140.  
  141.                MENUS42.DAT - This  is the file  which  contains all of  the
  142.                              menus for each of  the  levels as  well as the
  143.                              sections.   It should be placed in your  Telix
  144.                              directory.
  145.  
  146.                H42COMP.EXE - This is the file which does all the  data file
  147.                              compression.   It can be run  via  DOS and the
  148.                              command line, or internally using the provided
  149.                              user interfaces.   It should be placed in your
  150.                              Telix directory.
  151.                              (see section entitled "Data File Compression")
  152.  
  153.                ADDFILES.EXE - This program will allow you externally to tag
  154.                               files on any drive/directory and then add the
  155.                               tagged files to the file database.  It should
  156.                               be placed in your Telix directory.
  157.                               (See section  "ADDING FILES TO YOUR DATABASE"
  158.  
  159.  
  160.                                                                     Page: 4
  161.  
  162.                               for more information)
  163.  
  164.                USER42.DAT - This is  the file that  holds all  of the  user
  165.                             information, it is  created by  HOST42.SLC.  It
  166.                             will be created in your telix directory.
  167.                             (See section on HCONVERT)
  168.  
  169.                HOST42.LOG - This file is created by the HOST42  program, it
  170.                             is a  log of all  user logon's,  and what  each
  171.                             user  does  when  on  the system.  It  will  be
  172.                             created in your telix directory.
  173.  
  174.                HCONVERT.EXE - This program will allow you to  convert  your
  175.                               HOST3, HOST31, or HOST41 user data files into
  176.                               the new HOST42 data format.
  177.  
  178.  
  179.           OPTIONAL FILES:
  180.  
  181.                GATEWAY2.SYS - This is a program which can  control the  I/O
  182.                               during the time a user shell's  to  DOS,  and
  183.                               also  when  he views an  archive.  This  file
  184.                               should be in your root directory.
  185.                               (see the section entitled  "OPTIONAL EXTERNAL
  186.                               FILES" for more information)
  187.  
  188.                *.ASC/*.ANS - There are eight text files that are  optional.
  189.                              These  files will  need to  be  in your  Telix
  190.                              directory, if you are going to be  using them.
  191.                              (see  "OPTIONAL EXTERNAL FILES")
  192.  
  193.                HSHELL.BAT - This batch file if in the Telix directory  will
  194.                             be run automatically if the shell to DOS option
  195.                             has been executed from the Main Menu.
  196.                             (see section entitled "OPTIONAL EXTERNAL FILES"
  197.                             for more information)
  198.  
  199.                BLTS42.DAT - This is a pure ASCII data file which (if used),
  200.                             contains information regarding  the text  files
  201.                             which are to be used as bulletins.
  202.                             (see section entitled "OPTIONAL EXTERNAL FILES"
  203.                             for more information regarding format)
  204.  
  205.                DOORWAY.EXE - This fine program  by Marshall Dudley,  if  in
  206.                              the Telix directory, will be used in the shell
  207.                              to DOS unless  overridden  by the existence of
  208.                              HSHELL.BAT.
  209.                              (see section entitled "USING DOORWAY.EXE"  for
  210.                              more information)
  211.  
  212.  
  213.                                                                     Page: 5
  214.  
  215.                                      INSTALLATION
  216.  
  217.                This is an easy program to  install.  Below are some step by
  218.           step instructions on installing it:
  219.  
  220.                1) Put the  HOST42.SLC/H42UTILS.SLC  files  into your  Telix
  221.                   script directory.  (See Telix docs  on setting a  default
  222.                   script directory.)
  223.  
  224.                2) Place MENUS42.DAT, and H42COMP.EXE into  your main  Telix
  225.                   directory. (If wanted, ADDFILES.EXE should also be placed
  226.                   in the Telix directory)
  227.  
  228.                3) Run Telix, and then, when in Telix, run the HOST42 script
  229.                   (ALT-G, then type in HOST42).  HOST42 will  automatically
  230.                   start up with it's default configuration already set  up.
  231.                   You will need to run the configuration program to set  up
  232.                   your own configuration.  See the section  "H42UTILS ( The
  233.                   Configuration  Program )"  for  more information  on  the
  234.                   configuration of HOST42.
  235.  
  236.  
  237.  
  238.                           ACCESS LEVELS AND WHAT EACH CAN DO
  239.  
  240.                There are four access levels in this program.   This section
  241.           will describe what each level can do.
  242.  
  243.           Level 0: This is  the level of a new  user that logs on.  He  can
  244.                    not  do much  on the  board,  except  to chat,  leave  a
  245.                    comment to sysop, or to change their personal defaults.
  246.                    Optionally, the Sysop can have them logged off once they
  247.                    have input all of the information.
  248.  
  249.           Level 1: This is  your basic  user level.   The user can do  most
  250.                    of the  things available,  but there  are a  few  limits
  251.                    placed on the user.  For one, the user can only download
  252.                    a certain limit per call,  (as specified in the  program
  253.                    configuration.  Also they  can only  download  from  the
  254.                    download  directory,  and they can  NOT use  the extract
  255.                    archives command.
  256.  
  257.           Level 2: This user is  the same as the level 1 user, but does not
  258.                    have a download limit, and can use the extract  archives
  259.                    command.
  260.  
  261.           Level 3: This user can not only do all the Level 2 user can,  but
  262.                    can also download files from ANY directory on your disk.
  263.                    Hey can also  look at the daily  user log,  and can do a
  264.                    "Shell to DOS" IF he knows the  system password.  (Which
  265.                    is defined in the configuration program).
  266.  
  267.  
  268.                                                                     Page: 6
  269.  
  270.           Level 4: Your basic Sysop level.  Currently this level can do the
  271.                    exact same thing as the  Level 3 user with one addition.
  272.                    Having this level gives the user the option of  shutting
  273.                    down the system remotely, I would reserve this level for
  274.                    yourself (the sysop) only,  but if you have a  extremely
  275.                    good friend...well, that's up to you.
  276.  
  277.  
  278.  
  279.                                 LIST OF USERS COMMANDS
  280.  
  281.                This is a  list of all user commands,  and what each can do.
  282.           It is separated into  sections by levels.  Each higher level  can
  283.           do what the previous can do.
  284.  
  285.                                        Level 0
  286.           [P]age:  If the sysop is available, this command will ring a bell
  287.                    calling you to chat,  otherwise it will print a  message
  288.                    saying that the sysop isn't available. When the sysop is
  289.                    not  available,  the user  has  the option of  leaving a
  290.                    private message to him.
  291.  
  292.           [X]pert:  This  function allows the user to change his  expertise
  293.                     level, to one of three levels:
  294.  
  295.                          NOVICE: Gives a menu of commands.
  296.                          INTERMEDIATE: Gives the command letters as part of
  297.                                        the input line.
  298.                          EXPERT: NO help whatsoever!
  299.  
  300.           [G]oodbye:  Log's the user off.
  301.  
  302.           [Y]our Defaults:  Lets the user change their address, city,  zip,
  303.                             state, choose a default protocol, and turn  the
  304.                             pause function on or off.
  305.  
  306.           [C]omments to Sysop: This  option will allow the user to  write a
  307.                                private message to the sysop.
  308.                                (assumes there is a user using the  name  of
  309.                                SYSOP!)
  310.  
  311.  
  312.                                        Level 1
  313.  
  314.           [B]ulletins: This option goes to the bulletins menu  which allows
  315.                        the user to read them (if any)
  316.  
  317.           [M]essage Base: This option allows the user to go to the  message
  318.                           base  system.   Following  is a list of  commands
  319.                           available to them in the message base.
  320.  
  321.  
  322.                                                                     Page: 7
  323.  
  324.           Message Base Commands:
  325.  
  326.                [R]ead Messages: This allows the user to  read the  messages
  327.                                 in the message base.
  328.  
  329.                [W]rite Messages: This allows the user to  write a   message
  330.                                  to a user (either Public or Private).
  331.  
  332.                [K]ill Messages: This allows the user to  'Kill' a  message.
  333.                                 Level 1-3 users can only kill  messages  to
  334.                                 or  from themselves,  while a  Level 4  can
  335.                                 remove ANY message.
  336.  
  337.                [Q]uit to Main Menu: This allows the user to go back to  the
  338.                                     main menu.
  339.  
  340.           [F]ile System: This option allows the user to go to the File Base
  341.                          System.  Following is a list of commands available
  342.                          to them in the File Base.
  343.  
  344.           File Base Commands:
  345.  
  346.                [D]ownload:  Let's the user  Download  files.   Level 1  can
  347.                             only download a specified limit.  Levels 3+ can
  348.                             download from ANY directory.
  349.  
  350.                [U]pload:  Allows user to upload a file (if not  already  in
  351.                           the file database) to the system.
  352.  
  353.                [F]iles List:  This  shows the user a  listing of the  files
  354.                               which are available at his/her level.
  355.  
  356.                [X]tended File List: This allows the  user to see a  listing
  357.                                     of the files available at their  level,
  358.                                     but  includes the uploader, aprox. time
  359.                                     for transfer,  and more.
  360.  
  361.                [T]ype Text File:  Types  out a  text file  to  the  screen.
  362.                                   Pause can be toggled on or off by setting
  363.                                   it in the user defaults section, also  by
  364.                                   hitting  Ctrl-P the user  can pause,  and
  365.                                   Ctrl-X will abort the listing.  Levels 3+
  366.                                   can type files in ANY directory.
  367.  
  368.                [V]iew Archive:  Lets  the user view  an archive.  Levels 3+
  369.                                 can view archives in ANY directory.
  370.  
  371.                [Q]uit to Main Menu: This allows the user to go back  to the
  372.                                     main menu.
  373.  
  374.  
  375.                                                                     Page: 8
  376.  
  377.                                        Level 2
  378.  
  379.           File Base System Commands:
  380.  
  381.                [E]xtract from archives: This lets the  user  extract  files
  382.                                         from an archive,  the file is  then
  383.                                         archived (using PKZIP), into a temp
  384.                                         file called ( TEMPARC.ZIP ).  It is
  385.                                         deleted when the user hangs up.
  386.  
  387.  
  388.                                        Level 3
  389.  
  390.           [S]hell to DOS:  This lets the user shell to DOS.  If the user is
  391.                            remote (not keyboard) then they will be prompted
  392.                            for the system  password, if they fail  to enter
  393.                            it, they will not be able to shell.
  394.  
  395.           IMPORTANT!!!!:  There is NO current way to check on the status of
  396.                           the carrier.  Due to this fact, if the carrier is
  397.                           lost while a user is in DOS (via remote) then the
  398.                           SYSTEM  WILL HANG!.  The  only solution  if  this
  399.                           happens is to reboot the computer.
  400.  
  401.           System [L]og:  This shows the user the daily usage log. Hit Ctrl-
  402.                          P to pause, Ctrl-X to abort.
  403.  
  404.           File Base Commands:
  405.  
  406.                [S]how a Directory Listing:  Allows user to  do a listing of
  407.                                             the files in directory.
  408.  
  409.  
  410.                                        Level 4
  411.  
  412.           Control-Z:  This lets the user shut down the system.  The user is
  413.                       prompted for the system password.   If  they fail  to
  414.                       give it, the program will continue running.
  415.  
  416.           Message Base Commands:
  417.  
  418.                [P]ack Database: This allows  the level 4 user to do a  pack
  419.                                 of the message base (it is an interface  to
  420.                                 the H42COMP.EXE program).
  421.  
  422.           File Base Commands:
  423.  
  424.                [P]ack Database: This allows the  level 4 user to do a  pack
  425.                                 of the file base (it is a interface to  the
  426.                                 H42COMP.EXE program).
  427.  
  428.                [R]emove File: This allows the level 4 user to remove a file
  429.  
  430.  
  431.                                                                     Page: 9
  432.  
  433.                               from the database.
  434.  
  435.                [C]hange File: This allows  the level 4 user to  change  the
  436.                               file information in the database.
  437.  
  438.  
  439.  
  440.                               SYSOP'S KEYBOARD COMMANDS
  441.  
  442.                This is a list of the commands  available to the sysop.  Not
  443.           all commands are available at all times.
  444.  
  445.  
  446.                                 WHEN NO USER IS ONLINE
  447.  
  448.           F1:  This turns chat on or off.  The line in the status box shows
  449.                the current condition of chat. (If chat is turned off during
  450.                the Chat hours, then the "OFF" will be in red).
  451.                (See "H42UTILS  (The Configuration Program)" for more detail
  452.                on Chat Hours).
  453.  
  454.           F2:  This brings up the user  editor.  Note that there must be at
  455.                least ONE user, otherwise the user editor will NOT work.
  456.                (See "H42UTILS (The User Editor)"for more information on the
  457.                user editor)
  458.  
  459.           F8:  This allows the sysop to turn the status line of  HOST42  on
  460.                or off.  Having it off will increase the size of the viewing
  461.                screen by three lines.
  462.  
  463.           F9:  This allows the sysop to do a shell to DOS.
  464.  
  465.           C:   This runs the configuration program.
  466.  
  467.           U:   This will run the user compressor program, which will delete
  468.                any old or deleted users.  NOTE:  There must be at least one
  469.                user in the user file, or the compressor will not run.
  470.  
  471.           HOME: This brings up a box giving all the online commands.
  472.  
  473.           ESC: This will exit the program and go back to Telix.
  474.  
  475.  
  476.                                 WHEN A USER IS ONLINE
  477.  
  478.           F1:  Turns chat on or off (same as above)
  479.  
  480.           F2:  Runs user editor (same as above)
  481.  
  482.           F3:  Temporarily lowers the user's access.
  483.  
  484.           F4:  Temporarily raises the user's access.
  485.  
  486.  
  487.                                                                    Page: 10
  488.  
  489.           F5:  Temporarily lowers the time allowed by five minutes.
  490.  
  491.           F6:  Temporarily raises the time allowed by five minutes.
  492.  
  493.           F8:  Toggles Status Line (same as above)
  494.  
  495.           F9:  Shell to DOS (the user can not see)
  496.  
  497.           F10: Chat with user.
  498.  
  499.           END: Terminate user.
  500.  
  501.           ESC: Exit program to Telix.
  502.  
  503.           HOME: Bring up the help box.
  504.  
  505.  
  506.  
  507.                                      H42UTILS.SLC
  508.  
  509.                              (The configuration program)
  510.  
  511.                This program will allow you to change some important data in
  512.           the HOST42 program.  This  section will  tell what each  category
  513.           does:
  514.  
  515.           NOTE: The options  in the section "Page 2" are all located  on  a
  516.                 separate page in the  configuration program.  They  can  be
  517.                 accessed by pressing PgDn.  Once in the second page you may
  518.                 return to the first page by hitting PgUp.
  519.  
  520.  
  521.                                         Page 1
  522.  
  523.           Configure Modem: This option will allow you to do all the options
  524.                            for configuring the modem.  Below is the list of
  525.                            the five options:
  526.  
  527.                Auto Baud Detect: This controls the auto baud detect  of the
  528.                                  BBS.  If ON, the BBS will change the modem
  529.                                  to the speed of the connection.  If OFF it
  530.                                  will  leave the  modem  to change on  it's
  531.                                  own.  This  option is  primarily for  high
  532.                                  speed modems or for ones which  have error
  533.                                  correction  modes  where  the  port  speed
  534.                                  should remain constant.
  535.  
  536.                Modem Answer String: This is the string sent to the modem to
  537.                                     have it answer the phone.  The  default
  538.                                     string is "ATA", this  should work  for
  539.                                     most Hayes compatible modems.
  540.  
  541.  
  542.                                                                    Page: 11
  543.  
  544.                Modem Pickup String: This is the string sent to the modem to
  545.                                     cause it to go offhook (pick it up) ie.
  546.                                     Leaving the phone off hook.  This is in
  547.                                     conjunction with Pickup Modem in Local.
  548.                                     The  default is "ATM0H1",  this  should
  549.                                     work for most Hayes compatible modems.
  550.  
  551.                Pickup Modem in Local: This (if enabled)  will cause  HOST42
  552.                                       to go offhook when doing a local mode
  553.                                       logon.  This causes  the phone to  be
  554.                                       busy for any callers.
  555.  
  556.                Pickup Modem in Utils: This (if enabled)  will cause  HOST42
  557.                                       to go offhook when one of the utility
  558.                                       programs is run.  (ie configure, user
  559.                                       editor, user file  compressor,  shell
  560.                                       to DOS).
  561.  
  562.  
  563.           Configure Colors: This option allows the sysop to change the  BBS
  564.                             side (NOT ANSI Colors!) colors, ie. the  status
  565.                             bar colors/config option colors etc.
  566.  
  567.           Upload directory: This is the directory that all uploads will  go
  568.                             into.  It will also be a sub-directory and will
  569.                             be created, if it does not exist.
  570.  
  571.           Archive Directory: This is the directory that your archive utils.
  572.                              are  found in.  It must be an EXACT  directory
  573.                              or the program will NOT be able to do anything
  574.                              dealing with archives (VIEW/TEST/EXTRACT). The
  575.                              program will support (ARC/PAK/ZIP), but  there
  576.                              must be these files.
  577.  
  578.                                    For *.ARC's:
  579.                                         PKPAK.EXE
  580.                                         PKUNPAK.EXE
  581.                                    For *.ZIP's:
  582.                                         PKZIP.EXE
  583.                                         PKUNZIP.EXE
  584.                                    For *.PAK's:
  585.                                         PAK.EXE
  586.                                         (must have these commands!)
  587.                                              View: "V"
  588.                                              Test: "T"
  589.                                              Extract: "X"
  590.  
  591.           System Password: This is the password that is needed to shut down
  592.                            the system, or to shell to DOS.
  593.  
  594.           Time Chat is to come on: This is the time that you would like the
  595.                                    "Chatting  times" to  start.  Chat  will
  596.  
  597.  
  598.                                                                    Page: 12
  599.  
  600.                                    come on (regardless of current setting),
  601.                                    at this time, and  will stay on  (UNLESS
  602.                                    shutoff manually.  If set, the "OFF"  in
  603.                                    the status box will  change color),  and
  604.                                    will go off at the off time.
  605.  
  606.           Time Chat is to go off: This is the time that you would like  the
  607.                                   "Chatting times" to end.
  608.  
  609.           Time per access level: This is a  integer (in minutes)  which  is
  610.                                  given to a  user, per  access level.   For
  611.                                  example, if it was 20,  a 2nd  level  user
  612.                                  would be given 40 mins, while a  3rd level
  613.                                  user would get 60 mins.
  614.  
  615.  
  616.                                         Page 2
  617.  
  618.           Number of Downloads: This is the  number of  downloads  (per  one
  619.                                upload) a  user can make.   If  he  attempts
  620.                                to  download more, he will be told he  needs
  621.                                to upload more.
  622.  
  623.           Access limit: This is the limit (in K's!) that a level 1 user can
  624.                         download per call.
  625.  
  626.           User logon alarm: This is a little alarm that (if on)  will  ring
  627.                             when a user logs on.
  628.  
  629.           Level of Uploads: This is the access level  that a uploaded  file
  630.                             would be given once received.  If it is set  to
  631.                             a 1 then all access levels  can see it.  If set
  632.                             to 3 then only access  levels of 3 and 4  could
  633.                             see it.  This can be  changed by  changing  its
  634.                             level via the "Change File" option  in the file
  635.                             section.
  636.  
  637.           DOORWAY Command Line: This option allows you to change the string
  638.                                 sent to DOORWAY.EXE (If being used) when  a
  639.                                 user does a shell to DOS.  The default line
  640.                                 is "/S:* /A:ON /G:ON /V:D /M:100 /C:DOS".
  641.                                 This should work in most computers.
  642.                                 (See section "USING DOORWAY.EXE" for use of
  643.                                 DOORWAY.EXE)
  644.  
  645.           Log off new users: This (if on) will immediately log off any  new
  646.                              users as soon as they finish logging on.  This
  647.                              allows you  to keep new users  off the  system
  648.                              completely until you can validate them.
  649.  
  650.           Delete Bad Archives: This option if on will  delete any  archives
  651.  
  652.  
  653.                                                                    Page: 13
  654.  
  655.                                that have been tested as being bad.  If  off
  656.                                the archive will be  placed into the  upload
  657.                                directory but will NOT be added to the  file
  658.                                database.
  659.                                (See Section "ADDING FILES TO YOUR DATABASE"
  660.                                for more information about the database)
  661.  
  662.           Reset Default Options: If chosen this  option will  reset all  of
  663.                                  the configuration options to their default
  664.                                  values.
  665.  
  666.  
  667.  
  668.                                      H42UTILS.SLC
  669.  
  670.                                   (The User Editor)
  671.  
  672.                The User Editor will  allow you to  change some  information
  673.           about the user. There are two sections in this part. One is about
  674.           the different  functions in the  Editor, the other  is about  the
  675.           different categories.
  676.  
  677.  
  678.                                        Movement
  679.  
  680.                There are some special keys in the Editor that will move you
  681.           around.
  682.  
  683.                Up Arrow   : This will move you up one category
  684.  
  685.                Down Arrow : This will move you down one category
  686.  
  687.                Page Up    : This moves you to the top of the categories
  688.  
  689.                Page Down  : This moves you to the end of the categories
  690.  
  691.                Left Arrow : This moves you to the next user
  692.  
  693.                Right Arrow: This moves you to the previous user
  694.  
  695.                Control - V: This will take you to the next NEW user
  696.  
  697.                Control - S: This will initiate a search  through the  users
  698.                             names for a string (input by you)
  699.  
  700.  
  701.                                       CATEGORIES
  702.  
  703.                User's Name: This is the user's name.
  704.  
  705.                User's Password: This is the user's password.
  706.  
  707.  
  708.                                                                    Page: 14
  709.  
  710.                User's Access: This is the user's access level.
  711.  
  712.                User's Flag: This is the users status flag, A is  Active,  D
  713.                             is Delete, and B is Blacklist.
  714.  
  715.                User's Phone: This is the user's phone number.
  716.  
  717.                User's Address: This  is the  user's address.  It is divided
  718.                                into four parts:  the Address,  City, State,
  719.                                and Zip code.
  720.  
  721.                User Comment: This is a place to put in a comment.
  722.  
  723.                Last on: This shows when the user was last on
  724.  
  725.                Downloads: This shows how many downloads the user has made
  726.  
  727.                Uploads: This shows how many uploads the user has made
  728.  
  729.           NOTE:  There must  be at least one  user in the user file, or the
  730.                  Editor will not run.
  731.  
  732.  
  733.  
  734.                                OPTIONAL EXTERNAL FILES
  735.  
  736.           *.ASC/*.ANS - These are eight (four *.ASC/four *.ANS) files which
  737.                         you may create yourself, if  they are found in  the
  738.                         Telix directory, they will be displayed to the user
  739.                         at certain times as follows:
  740.  
  741.                LOGON.* :   This file is displayed when a user first logs on
  742.  
  743.                NEWS.* :   This file is displayed after a user has logged on
  744.                           and they have successfully entered their password
  745.  
  746.                BYEBYE.* :   This file is  displayed when the user quits the
  747.                             BBS.
  748.  
  749.                NEWUSER.* :  This file is displayed to all new users.
  750.  
  751.           IMPORTANT!:  The input buffer for these files is set at the level
  752.                        of 255 characters per line.  If your files have more
  753.                        characters per line they will NOT be sent correctly!
  754.  
  755.           NOTE:  For some reason I have been having some problems with some
  756.                  ANSI  graphics screens.  I'm not sure exactly why, but  it
  757.                  occurs mostly when typing a large animated ANSI picture, I
  758.                  hope to have this fixed by the next version. Try different
  759.                  line sizes if you have problems (best way is NOT using any
  760.  
  761.  
  762.                                                                    Page: 15
  763.  
  764.                  animation!)
  765.  
  766.           HSHELL.BAT - This batch file if found in the Telix directory will
  767.                        be run when a online  user does a shell to  DOS.  It
  768.                        will override ALL other shell options.  The order in
  769.                        which the shell options take precedence is:
  770.  
  771.                               HSHELL.BAT
  772.                               DOORWAY.EXE
  773.                               GATEWAY2.SYS
  774.                               CTTY COMX
  775.  
  776.           DOORWAY.EXE - This program, if found  in the Telix directory  and
  777.                         if the previous shell  option has failed,  will  be
  778.                         run as a shell to DOS for the online user.  It will
  779.                         allow the user to run MOST major programs online if
  780.                         the  user has a  Communications program  which  can
  781.                         support a Doorway Mode.
  782.                         (See section entitled "USING DOORWAY.EXE" for  more
  783.                         information)
  784.  
  785.           GATEWAY2.SYS - If installed and all previous options have  failed
  786.                          GATEWAY2.SYS  will be used.   To install, add  the
  787.                          following line to your CONFIG.SYS file:
  788.  
  789.                              DEVICE = GATEWAY2.SYS -D -(COM PORT)
  790.  
  791.                          Where (COM PORT) stands for the com port that your
  792.                          modem is in.  For example (the modem is in com 2):
  793.  
  794.                              DEVICE = GATEWAY2.SYS -D -2
  795.  
  796.                          For more information regarding  Installation   and
  797.                          more details about GATEWAY2.SYS read the  included
  798.                          GATEWAY2.DOC file.
  799.  
  800.                          Unlike DOORWAY.EXE using GATEWAY2.SYS will NOT let
  801.                          you run programs that  use direct  screen  writes,
  802.                          (Most MAJOR programs!)  Do *NOT* attempt to run  a
  803.                          program which uses direct screen writes and direct
  804.                          keyboard scans as it will LOCK your computer up!
  805.  
  806.           BLTS42.DAT - This is a straight ASCII file which you can  create,
  807.                        that contains the information  for some  bulletins.
  808.                        (Five bulletins total).  Each bulletin  takes up one
  809.                        line in the file.  The information for  them are  in
  810.                        this format:
  811.  
  812.                            DRIVE:\PATH\FILENAME.EXT;Displayed information
  813.                        Where Drive:\Path\Filename.ext is the EXACT path and
  814.  
  815.  
  816.                                                                    Page: 16
  817.  
  818.                        name of the bulletin, and Displayed  information  is
  819.                        information  displayed  to the user,  with  the  two
  820.                        being separated by a semicolon ';'.  For example:
  821.  
  822.                            C:\DOS\DOCS\REGISTER.DOC;Info on registering.
  823.  
  824.                        Where the document REGISTER.DOC being the file to be
  825.                        displayed and the user would see the bulletin as:
  826.  
  827.                            1 Info on registering.
  828.  
  829.  
  830.  
  831.  
  832.                                 Data File Compression
  833.  
  834.  
  835.                                      H42COMP.EXE
  836.  
  837.           This program will allow you to compress the three different  data
  838.           files.  The three are  the user data file, the message base  data
  839.           file and the file base data file.  The program may be run  either
  840.           from within HOST42 (User Compressor, and  Pack Base  commands  in
  841.           both Message Base and File Database), or from the DOS Prompt.  By
  842.           typing H42COMP at the dos prompt you will be shown a  listing  of
  843.           the different commands.  Briefly those commands are:
  844.  
  845.           P - Path To Data files: For when you are running the program from
  846.                                   a directory OTHER then the directory  the
  847.                                   data files are in.  Example usage:
  848.  
  849.                                     H42COMP p\TELIX
  850.  
  851.           U - Compress User File: This command runs  the user compressor it
  852.                                   has one extra optional switch which is:
  853.  
  854.                                   D:(x) - Days since last call
  855.  
  856.                                   Where (x) is a number of days allowed for
  857.                                   users to have last connected.   If it  is
  858.                                   not used the program will default to 30.
  859.  
  860.           M - Compress Message Base: This  command runs  the  message  base
  861.                                      compressor.  It has two extra optional
  862.                                      switches:
  863.  
  864.                                      K - Kill Private
  865.  
  866.                                      This switch will delete *ALL*  private
  867.                                      mail which has been read.
  868.  
  869.                                      D:(x) - Days to allow
  870.  
  871.  
  872.                                                                    Page: 17
  873.  
  874.                                      Where (x) is number of days allowed to
  875.                                      keep old messages.  Default setting is
  876.                                      30 days.
  877.  
  878.           F - Compress File Database: This runs the file base compressor it
  879.                                       has three extra optional switches:
  880.  
  881.                                       D - Sort By Date
  882.  
  883.                                       This switch will do a sort based upon
  884.                                       the file date as opposed to a  normal
  885.                                       alphabetical sort.
  886.  
  887.                                       R - Reverse Sort
  888.  
  889.                                       This switch reverses the sort routine
  890.                                       making it sort the greatest (be it in
  891.                                       date or alphabetically) first and the
  892.                                       smallest last (ie files would be Z-A)
  893.  
  894.                                       K - Kill files not found
  895.  
  896.                                       This switch causes the program to run
  897.                                       a check on each file to see if it  is
  898.                                       actually there.  If the  file is  NOT
  899.                                       found, then it  will be removed  from
  900.                                       the database.
  901.  
  902.  
  903.  
  904.                           Converting Previous File Formats
  905.  
  906.                                      HCONVERT.EXE
  907.  
  908.           This program will let you convert your user data files from  both
  909.           HOST3, HOST31, and HOST41 into the new HOST42 data format.   Just
  910.           place this program in  the same directory  as your data file  and
  911.           type:
  912.  
  913.           HCONVERT
  914.  
  915.           At the DOS prompt.  It will then prompt you to choose which  data
  916.           format you wish to convert FROM.  Pick the proper  format and  it
  917.           will then convert it for you.   HCONVERT will erase the old  data
  918.           file and leave you with the new USER42.DAT file.  You should keep
  919.           a backup of the old data file when running HCONVERT, in the event
  920.           that something goes wrong.  You might also need to do some  minor
  921.           editing of the data file in some extreme cases where the old data
  922.           file was slightly corrupted.
  923.  
  924.  
  925.                                                                    Page: 18
  926.  
  927.                             ADDING FILES TO YOUR DATABASE
  928.  
  929.           With the release of HOST41, HOST now uses a file database  system
  930.           of files  as opposed to  earlier versions  (HOST3, HOST31)  which
  931.           just let users have  files in a specific  drive/directory.  While
  932.           the old system was simple to use (If you wanted  a new file to be
  933.           downloadable you  just put it in the  directory) it was not  only
  934.           unsafe (no  control over who downloaded what) but it also had  no
  935.           descriptions of the file nor of who uploaded it. The new database
  936.           system allows the sysop  to have files from ANY  drive/directory,
  937.           and  is also  access level  orientated (meaning a  file could  be
  938.           seen/downloaded by only a specific access level (or higher) user)
  939.           Plus, it also allows for descriptions  of files, and keeps  track
  940.           of  who uploaded  the file.
  941.  
  942.           Because of the new system, the sysop can not  just copy the  file
  943.           into  a directory  and have  it be  available.  The file  must be
  944.           added to the database.  The simplest way of doing this is just to
  945.           do a local logon and then do a upload of the file (just like  any
  946.           user might do).  If the file is in the uploads directory then  it
  947.           will be checked, and then HOST42 will ask you for the description
  948.           of the file. If a file that is not in the uploads directory needs
  949.           to be added to the database all that is needed is to just  upload
  950.           the file with it's FULL path in front.  Example:
  951.  
  952.           C:\DOS\ZIPS\GAME.ZIP
  953.  
  954.           This would add the file GAME.ZIP to the database and when  a user
  955.           downloaded, or viewed it, the exact path would be used.  Just  as
  956.           if the file had been in the uploads directory.
  957.  
  958.           Adding multiple files to the database is just as simple.  If  you
  959.           have five or six files  to upload in a  directory other than  the
  960.           uploads  directory, just  upload the  directory name  and  "*.*".
  961.           Example:
  962.  
  963.           C:\DOS\ZIPS\*.*
  964.  
  965.           HOST42 would go through  and ask you if you wanted to upload each
  966.           file  available in the  directory until all the  files  have been
  967.           processed.
  968.  
  969.           There is also a new external program called ADDFILES.EXE that you
  970.           can use to add files to the database.  ADDFILES.EXE allows you to
  971.           tag files from any  drive or directory by  pressing the Space Bar
  972.           on the file to tag it (Space Bar again will untag the file).   F2
  973.           will allow you to  change drives.  Once  you have tagged all  the
  974.           files you want added, press F1.  ADDFILES will  then show you the
  975.           information for each file, you may change any information as  you
  976.           want (Make sure you hit RETURN each time you change before  going
  977.           to the next item). To add the file to the database you must press
  978.           F2.  If you press F2 and a beep sounds  this means that  the file
  979.  
  980.  
  981.                                                                    Page: 19
  982.  
  983.           is  already  present in the  database.  If  you wish  to skip the
  984.           current file just press F1. You may press F10 to exit the program
  985.           at any time.
  986.  
  987.  
  988.                                   USING DOORWAY.EXE
  989.  
  990.                DOORWAY.EXE is a program  written by Marshall Dudley,  which
  991.           allows a online user to Shell to DOS and not only run all of  the
  992.           DOS commands but also to run almost ANY program online.   DOORWAY
  993.           redirects the input and output of the programs to the com port as
  994.           well as to the console allowing not only the user to see what  is
  995.           running but also to allow the  sysop to view it as well.  To  use
  996.           DOORWAY.EXE  with HOST42,  you must be running ANSI.SYS  (Or  any
  997.           ANSI program with the exception of FANSI-Console) and you need to
  998.           place the DOORWAY.EXE program into your Telix directory.  Once  a
  999.           user shells to DOS then  DOORWAY.EXE will run.  The user  can now
  1000.           use any  DOS commands they  want.  If the  user wishes  to run  a
  1001.           program they will first need to turn on the DOORWAY mode on their
  1002.           own terminal program (ALT = for Telix) (Have user check for other
  1003.           communications programs) once they are  finished in DOS they  may
  1004.           type EXIT (just as if in a DOS shell)  and they will be  returned
  1005.           to HOST42 (If they have invoked their terminal into DOORWAY  mode
  1006.           they will need to turn it off before they will be able to use any
  1007.           of it's functions again).  If during anytime while the user is in
  1008.           DOS they hang up or loose carrier somehow, DOORWAY.EXE will do  a
  1009.           reboot  of the computer automatically.  If you have any  problems
  1010.           running DOORWAY.EXE you can change the command line which is sent
  1011.           to DOORWAY.EXE in the configuration  program (Option "M").   This
  1012.           will allow you to change it until you fix whatever problems might
  1013.           occur.
  1014.  
  1015.           NOTE: When running DOORWAY.EXE under Telix/HOST42 there might  be
  1016.                 a minimal amount of RAM available, which might not allow  a
  1017.                 user to run certain programs.
  1018.  
  1019.  
  1020.                                       DISCLAIMER
  1021.  
  1022.           This program is  provided as is,  and is to  be run at  your  own
  1023.           risk.  There is  NO  warranty of any kind or  form covering  this
  1024.           program.  Exis Inc., Colin Sampaleanu, and the author are  not in
  1025.           any way responsible, or liable for any damages  of any kind  that
  1026.           may arise from the usage of this program, or that of any programs
  1027.           or files associated, or included with it.
  1028.  
  1029.           TELIX.EXE, SALT,  HOST.SLC,  HCONFIG.SLC:  Copyright   1986,1987,
  1030.           1988, 1989 by Exis Inc., and Colin Sampaleanu.
  1031.           Used with permission.
  1032.  
  1033.           DOORWAY.EXE Copyright 1987, 1988, 1989 by Marshall Dudley.
  1034.           Used without permission.
  1035.  
  1036.  
  1037.                                                                    Page: 20
  1038.  
  1039.  
  1040.                                         THANKS
  1041.  
  1042.                There are a few people to whom I would  like to give special
  1043.           thanks to,  for their  help and  cooperation in  my  endeavor  to
  1044.           create this program:
  1045.  
  1046.                Marvin Blackburn:  My *FIRST* registered  user  and my  most
  1047.                                   important  beta  tester,  his  input  and
  1048.                                   support have done the most for HOST!
  1049.                                         Thank you VERY much Marvin!
  1050.  
  1051.                Jack Gordon:  My best beta tester!   His outstanding  effort
  1052.                              in testing has helped me create a  (hopefully)
  1053.                              bug free program.  Thanks Jack!
  1054.  
  1055.                Tony Gentile:  My friend and C "teacher"  who taught  me the
  1056.                               basics of  the C  language,  which  helped  a
  1057.                               GREAT deal  when working on this program.
  1058.                                    Thanks Tony.
  1059.  
  1060.                Jay Norwalk:  Who edited my documentation for me, giving  me
  1061.                              hints and corrected my mistakes.  Thanks Jay!
  1062.  
  1063.                Bill Parfitt:  The sysop of dBored  (619-748-3644), who  not
  1064.                               only gave me a LOT of support, but gave me  a
  1065.                               good place  to put my  program as  well,  but
  1066.                               also  gave me my own conference!
  1067.  
  1068.                                    VERY special thanks to you Bill!
  1069.  
  1070.  
  1071.           And finally,
  1072.  
  1073.                Colin Sampaleanu:
  1074.  
  1075.                For the extremely  hard work and  numerous, uncounted  hours
  1076.           that he has put into creating TELIX, which is the  very BEST  (in
  1077.           my opinion) telecommunications program package out there!
  1078.           Without it this program wouldn't be around.
  1079.  
  1080.                EXTRA thanks to you Colin!
  1081.  
  1082.  
  1083.                                                                    Page: 21
  1084.  
  1085.  
  1086.                                      WHAT'S NEW?
  1087.  
  1088.                     o Added support for user selectable  ANSI colors.   The
  1089.                       user can now change the six ANSI colors to their  own
  1090.                       preference and the changes will be saved as defaults.
  1091.  
  1092.                     o Added support for MNP type connections.  Now if there
  1093.                       is a MNP connection the user will be  allowed to  use
  1094.                       the "G" protocols.  If no MNP connection the use will
  1095.                       not be allowed.
  1096.  
  1097.                     o Added better support for ZIP files during testing  of
  1098.                       them after a upload.  Now archives which have a  file
  1099.                       which might  fail the CRC  check, or  ones which  are
  1100.                       encrypted will be added to the file database anyway.
  1101.  
  1102.                     o Added option  to NOT delete  archives that  fail  the
  1103.                       test after a upload, bad files will be placed  in the
  1104.                       upload  directory but  will not be added  to the file
  1105.                       database.
  1106.  
  1107.                     o Added ability for Sysop to edit the command line sent
  1108.                       to DOORWAY.EXE (if used). This allows sysop to change
  1109.                       any parameters needed.
  1110.  
  1111.                     o Added support for HOST42 to go offline when the sysop
  1112.                       does a local mode logon, as well as  when one of  the
  1113.                       utility programs is run.
  1114.  
  1115.                     o Added support for Tandy users who have the '\' key on
  1116.                       the numeric keypad only.  HOST42 will  not allow  the
  1117.                       use of that key, so users can now use the '/' instead
  1118.                       of the '\' in all filenames.
  1119.  
  1120.                     o Changed way HOST42 answer's the phone. Now instead of
  1121.                       using Telix's Auto Answer String, HOST42  will  watch
  1122.                       for a "RING" to be echoed from the modem and then  it
  1123.                       will answer using "ATA" (String to  answer phone  can
  1124.                       be changed in Configuration program for modems  which
  1125.                       do not conform to the Hayes command set)
  1126.  
  1127.                     o Fixed many numerous bugs from the previous release.
  1128.  
  1129.  
  1130.                                                                    Page: 22
  1131.  
  1132.  
  1133.                              WHAT'S AHEAD IN THE FUTURE?
  1134.  
  1135.                Now that Colin has increased the size of scripts from 32K to
  1136.           64K I have some more room to work in (about 10K now).   So now  I
  1137.           can add more of my last want list, as well as some new ideas.
  1138.  
  1139.                Full Screen Message Editor:  This will  allow the  users  to
  1140.                                             write their  messages in a full
  1141.                                             screen editor,  allowing   full
  1142.                                             cursor control and more editing
  1143.                                             features.
  1144.  
  1145.                Online Programs:  A online  sysop  definable program section
  1146.                                  which will be able to  run door  programs,
  1147.                                  including some SALT door scripts which are
  1148.                                  already being written.
  1149.  
  1150.                BBS List:  A full working BBS listing program,  where the  a
  1151.                           user can add information about other BBS's.
  1152.  
  1153.                CallBack Door: This is a scripted DOOR  which is a  CallBack
  1154.                               Verification door.   It is  already   written
  1155.                               and has been beta tested already.
  1156.  
  1157.                External Protocols:  Will allow the sysop to add some (up to
  1158.                                     four), external protocols. (Telix  only
  1159.                                     only has space for four protocols).
  1160.  
  1161.  
  1162.                                                                  Page: 23
  1163.  
  1164.  
  1165.                                   TECHNICAL SUPPORT
  1166.  
  1167.                If you have any  suggestions or ideas for the next  version,
  1168.           or any problems, or, (God forbid), bugs.   You may  get a hold of
  1169.           me at these locations:
  1170.  
  1171.              BEST WAY!-> dBored of San Diego, (619) 748-3644
  1172.                            (Prodoor Conf. HOST3)
  1173.  
  1174.                          Telix Support BBS, (416) 439-8239
  1175.                          PCRelay, Communications conference
  1176.                          PCRelay, Telix Conference
  1177.  
  1178.                          FIDO Net Telix Conference
  1179.  
  1180.                          Call me voice at: (602) 870-0139
  1181.  
  1182.                          Or mail me:
  1183.  
  1184.                                  Dan Horn
  1185.                                  2122 West Butler Drive #161
  1186.                                  Phoenix, AZ  85021
  1187.  
  1188.  
  1189.